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INTRODUCTION 

The  Elographics  E270  Transparent  Touch  Sensor  has  been  acquired  for 
use  on  Che  Human  Factors  Research  Simulator.  An  Interface  Controller  has 
been  built  by  the  US  Army  Human  Engineering  Laboratory  (USAHEL)  for  inter¬ 
facing  the  Touch  Sensor  to  the  Digital  Equipment  Corporation  (DEC)  PDP 
11/34  minicomputer.  This  manual  provides  the  basic  operational  and  pro¬ 
gramming  information  for  using  the  Touch  Sensor  on  the  DEC  PDP  11/34  com¬ 
puter.  The  user  should  be  familiar  with  Che  PDP  11/34  and  the  MACRO 
assembly  language  to  fully  understand  the  Information  in  this  manual.  The 
PDP  11  Processor  Handbook  and  the  PDP  11  Bus  Handbook  provide  a  more  de¬ 
tailed  description  of  Che  PDP  11/34  computer  and  UNIBUS.  Appendix  B  de¬ 
scribes  FORTRAN  subroutines  which  provide  user  access  to  the  Touch  Sensor 
for  FORTRAN  program  applications. 


GENERAL  DESCRIPTION 

The  Touch  Sensor  is  a  transparent  pressure  sensitive  panel  designed  to 
form  fit  Che  Vector  General  Graphics  Display  System  cathode  ray  tube  (CRT). 
The  Touch  Sensor,  along  with  the  Touch  Sensor  Controller  and  the  Interface 
Controller,  provides  an  active  area  on  the  display  surface  that  responds  to 
touch  when  under  program  control.  Information  displayed  on  the  CRT  can  be 
manipulated  by  simple  finger  Couch  action  on  the  CRT  surface.  The  Touch 
Sensor  has  nearly  infinite  resolution,  but  is  limited  to  1023x1023  area  by 
the  analog-to-dlglCal  converters  of  the  Touch  Sensor  controller  (Figure 
1). 


DETAILED  DESCRIPTION 

The  Touch  Sensor  consists  of  three  elements:  the  Touch  Sensor,  the 
Touch  Sensor  Controller,  and  the  Interface  Controller.  All  of  these 
elements  when  installed  and  operating  in  the  computer  system  require  no 
operator  action  ocher  than  programming  the  PDP  11/34  computer  for 
specialized  use  of  Che  Touch  Sensor  (Figure  2). 


Touch  Sensor 

The  Touch  Sensor  is  a  transparent  pressure  sensitive  panel  that 
responds  to  couch  when  under  program  control.  Affixed  to  the  Vector 
General  Display  CRT,  the  Touch  Sensor  is  made  of  a  glass  sheet,  coated  with 
a  transparent  resistive  layer  on  one  side.  It  is  covered  by  a  plastic 
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Figure  2.  Touch  sensor  configuration. 


cover  sheet,  coated  with  a  transparent  conductive  layer  on  the  side  facing 
the  resistive  layer.  Pressure  applied  to  the  plastic  cover  sheet  causes 
the  resistive  and  the  conductive  layers  to  contact  resulting  in  a  contact 
point  being  generated.  Once  touch  down,  due  to  finger  pressure,  Is 
detected,  two  analog  voltages  are  generated  for  the  touched  area 
representing  the  X  and  Y  coordinates  on  the  1023x1023  resolvable  area  of 
the  Touch  Sensor  (Figure  1). 


Touch  Sensor  Controller 

The  Touch  Sensor  Controller  supplies  the  voltages  for  the  X  and  Y  axis 
on  the  Touch  Sensor  and  digitizes  the  analog  voltage  levels  generated  by 
the  Touch  Sensor  at  the  point  of  contact.  The  controller  provides  two 
operational  modes:  single  point  mode  that  digitizes  the  analog  voltage 
levels  every  time  the  Touch  Sensor  Is  touched  and  released,  and  a  stream 
mode  that  digitizes  at  a  60-hertz  rate  as  long  as  contact  on  the  Touch 
Sensor  is  maintained.  Once  the  analog  voltages  are  digitized,  they  are 
ready  for  transfer  In  the  form  of  two  10-bit  parallel  outputs  representing 
the  X  and  Y  coordinates  In  binary  form.  The  electronics  for  the  Touch 
Sensor  Controller  are  contained  in  a  mounting  chassis  which  fits  In  a  19" 
relay  rack. 


Interface  Controller 

The  Interface  Controller  contains  all  the  logic  necessary  for  program 
control  of  the  Touch  Sensor  on  the  POP  11/34.  Built  around  the  DEC  M1710 
Unlbus  Foundation  Module,  the  Interface  Controller  provides  the  data  link 
between  the  computer  and  the  Touch  Sensor.  Assigned  octal  device  addresses 
from  164040  through  164044,  and  an  interrupt  octal  vector  address  170;  the 
Interface  Controller  allows  recognition  of  MACRO  formatted  instructions, 
thus  enabling  program  control  of  the  Touch  Sensor  by  address  decoding, 
device  sensing,  interrupt  generation,  and  data  transferring  between  the 
Touch  Sensor  and  the  computer. 

The  Interface  Controller  hardware  consists  of  two  circuit  boards:  a 
Camblon  wire  wrap  board  located  in  a  19"  Cambion  card  cage  and  an  M1710 
Unlbus  Foundation  Module  located  in  the  DEC  BAIl  KE  Expansion  Cabinet. 


THEORY  OF  OPERATION 


Analog  Data  Generation 

A  voltage  is  alternately  applied  to  the  X  and  Y  axis  on  the  resistive 
layer  on  the  Touch  Sensor.  Finger  pressure,  applied  at  a  point  on  the 
plastic  cover  sheet,  causes  the  conductive  layer  to  contact  the  resistive 
layer.  This  generates  two  voltage  levels  forming  the  X  and  Y  coordinates 
in  the  form  of  analog  voltage  levels,  one  for  the  X  axis  and  one  for  the  Y 
axis.  These  analog  voltage  levels  (analog  data)  are  picked  up  by  a  sense 
line  and  applied  to  the  Touch  Sensor  Controller  (Figure  3). 
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Tlu-  an  ;  1  ■  '  volt-am?  '.tvi.-ls  are  applied  to  the  Analog  to  Digital  Con¬ 
verter  (ADC)  locatid  In  the  Touch  Sensor  Controller.  The  ADC  samples  the 
analog  voltage  levels,  and  then  converts  them  Into  10-bit  binary  values; 
one  for  the  X  coordinate  address  and  one  for  the  Y  coordinate  address. 
These  values  can  range  frou  0  to  1023  depending  upon  the  point  of  contact 
on  the  Touch  Sensor.  Once  the  X  and  Y  values  are  determined,  they  are 
temporarily  stored  in  two  10-blt  register  called  the  X  and  Y  Latch 
Registers,  and  a  DATA  READY  L  signal  is  asserted,  signifying  data  is 
available  to  the  Interface  Controller  (Figure  3). 


X  Re  g  i  s  t  e  r 

Located  in  the  Interface  Controller  on  a  Camblon  wire  wrap  board,  the 
X  Register  is  a  10-bIt  temporary  storage  register  for  the  binary  coordi¬ 
nate  address  of  the  X  axis  prior  to  being  placed  on  the  Unlbus  of  the  cc 
puter.  When  DATA  READY  L  is  received  from  the  Touch  Sensor  Controller, 
data  from  the  X  Latch  Register  is  strobed  to  the  line  receivers  and  pla  1 
in  the  X  Register  of  the  Interface  Controller  (Figure  4). 


Y  Register 

The  Y  Register,  also  located  in  the  Interface  Controller  on  a  Cambion 
wire  wrap  board,  1s  a  10-blt  temporary  storage  register  for  the  binary 
coordinate  address  of  the  Y  axis  prior  to  it  being  placed  on  the  Uni  bus  of 
the  computer.  When  DATA  READY  L  is  received  from  the  Touch  Sensor 
Controller,  tlie  data  from  the  Y  Latch  Register  is  strobed  to  the  line 
receivers  and  placed  in  the  Y  Register  of  the  Interface  Controller  (Figure 

Data  Is  now  in  the  X  and  Y  Registers  representing  the  point  of  contact 
on  the  Touch  Sensor  and  awaiting  computer  action.  Further  action  is  per¬ 
formed  according  to  a  sequence  of  computer  program  instructions. 


Command  Status  Register  (CSR) 

Located  on  a  Cambion  wire  wrap  board,  the  Command  Status  Register 
(CSR)  is  a  15-blt  temporary  storage  register  for  storing  the  status  and 
control  information  of  the  Touch  Sensor  (Figure  5).  Of  these,  only  four 
are  of  any  significance  to  the  user  and  are  as  follows:  Bit  7,  when  set, 
indicates  data  is  ready  in  the  X  and  Y  Registers;  Bit  6,  when  set,  enables 
the  Interrupt  capability;  Bit  0,  when  set,  activates  the  reset  command;  and 
Bit  1,  when  set,  activates  the  stream  mode  and  when  reset,  activates  the 
single  point  mode.  Bit  initiation  is  accomplished  by  executing  a  data 
transfer  instruction  to  the  CSR  except  for  the  Data  Ready  Bit  which  is 
Initiated  only  by  the  Touch  Sensor  Controller.  The  CSR  may  be  accessed  for 
evaluation  by  executing  a  data  transfer  from  the  CSR  to  an  address  location 
selected  by  the  user. 
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Figure  4.  X/Y  Registers  and  Control. 
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Address  Selection  Logic 

The  execution  of  a  data  transfer  instruction  causes  the  appropriate 
address  bits  (AOO  through  A17)  and  the  control  bits  (COO  and  COl  )  to  be 
placed  on  the  Unibus  (Figure  6).  Each  device  on  the  Unibus  receives  the 
address  and  control  bits  and  proceeds  to  decode  them.  After  a  short  delay 
for  deskew,  MSYN  L  is  asserted  by  the  Master.  Each  device  receives  MSYN  L, 
and  after  address  decoding  only  the  selected  device  responds,  asserting 
DEVICE  ENBL  L.  DEVICE  ENBL  L  enables  the  4  to  6  line  decoder,  and 
depending  upon  the  input  conditions  on  AOl  through  A04  ,  asserts  the 
corresponding  SEL  signal  (Figure  6). 


Register  Select  Logic 

When  a  device  address  is  placed  on  the  Unlbus  address  line,  address 
lines  A1  through  A4  determine  the  select  signal  (SEL)  asserted  which  in 
turn  selects  the  X  Register,  Y  Register,  or  CSR  Register.  A  binary  code  of 
0000  placed  on  the  address  line  AOl  through  A04  asserts  SEL  0  (Figure  6). 
This  in  turn  enables  the  SEL  CSR  FF  to  set  upon  the  assertion  of  DEVICE 
ENBL  d+,  thus  selecting  the  CSR  (Figure  5). 

A  binary  code  of  0001  placed  on  address  lines  AOl  through  A04  asserts 
SEL  2.  This  enables  the  SEL  X  FF  to  be  set  when  DEVICE  ENBL  d+  is  asserted 
(Figure  6).  X/Y  ENBL  Is  then  asserted  which  places  the  contents  of  the  X 
Register  on  input  lines  ( INOO  through  INIO)  (Figure  5). 

A  binary  code  of  0010  placed  on  address  lines  AOl  through  A04  asserts 
SEL  4  (Figure  6).  This  enables  the  SEL  Y  FF  to  be  set  when  DEVICE  ENBL  d+ 
Is  asserted.  X/Y  ENBL  is  then  asserted  which  places  the  contents  of  the  Y 
Register  on  input  lines  (INOO  through  INIO)  (Figure  5). 


Gating  Control 

Unlbus  control  lines  COO  and  COl  designate  the  type  of  data  trans¬ 
action  either  a  data-in  (DATI)  or  a  data-out  (DATO)  with  respect  to  the 
Master  device  (Figure  6). 

DATI  transactions  (C00=0  and  COl*!)  causes  data  transfers  from  the  X 
Register,  Y  Register,  or  the  Command  Status  Register  to  the  address  speci¬ 
fied  by  the  processor. 

DATO  transactions  (C00=1  and  COl-0)  cause  data  transfers  from  the 
processor  the  Command  Status  Register  which  is  the  only  register  capable  of 
two-way  data  transfers. 
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Data  Bus  Interface 


The  Data  Bus  Interface,  located  on  tVie  M1710  Interface  Module, 
contains  the  Unlbus  drivers  and  receivers,  establishing  the  two-way  data 
path  between  the  Touch  Sensor  and  the  computer.  Data  to  be  transferred 
from  the  Touch  Sensor  Is  placed  on  Input  lines  INOO  through  INIO  awaiting 
the  DRIVER  ENBL  L  signal.  Assertion  of  DRIVER  ENBL  L  places  the  data  on 
the  Unlbus  for  transfer  to  the  computer  (Figure  7). 


Bus  Request  Logic 

The  Bus  Request  Logic  provides  the  Interrupt  capability  for  the  Touch 
Sensors  (Figure  8).  INT  ENBL  Bit  6  of  the  CSR  must  be  set  to  generate  Bus 
requests.  INT  ENBL  coupled  with  DATA  READY  H  from  the  Touch  Sensor  asserts 
REQUEST.  REQUEST  asserts  BR4L  on  the  Unlbus  initiating  the  Interrupt 
arbitration  sequence.  Upon  completion  of  arbitration  sequence,  the 
requesting  device  (Touch  Sensor)  becomes  master  and  asserts  MASTER  L 
which,  in  turn,  asserts  START  INTR  L  and  places  the  interrupt  vector  and 
INTRL  on  the  Unlbus  data  line.  INTR  L  asserted  signifies  to  the  fielding 
processor  that  an  Interrupt  vector  is  on  the  D  lines.  The  fielding 
processor  strobes  the  vector  from  the  D  lines  and  asserts  SSYN  L.  Receipt 
of  SSYN  L  causes  the  requesting  device  to  remove  the  Interrupt  vector  and 
INTR  from  the  UNIBUS.  The  fielding  processor  then  removes  SSYN  L  informing 
the  arbitrator  that  it  may  start  issuing  BGs  again. 


Data  Accepted 

Activation  of  the  data  accepted  logic  requires  the  sequential  execu¬ 
tion  of  two  data  transfer  instructions  from  the  X  and  Y  Registers.  The 
first  data  transfer  instruction  partially  enables  activation  of  the  DATA 
ACCEPTED  one  shot  by  asserting  DEVICE  ENBL  and  X/Y  ENBL  L.  Completion  of 
the  second  data  transfer  instruction  asserts  COUNT  CD  which  enables  the 
DATA  ACCEPTED  one  shot.  Assertion  of  DATA  ACCEPTED  then  resets  the  DATA 
READY  FF  in  the  Touch  Sensor  Controller,  making  it  available  for  processing 
another  set  of  X  and  Y  coordinate  values. 


USING  THE  TOUCH  SENSOR 

Using  the  Touch  Sensor  requires  writing  MACRO  language  subroutines  or 
using  FORTRAN  callable  subroutines  as  specified  in  Appendix  B. 
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Figure  7.  M1710  Bus  Drivers  and  Bus  Receivers 
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Programming  Guidance  for  the  Touch  Sensor 
Initiate  the  System 

Before  using  the  Touch  Sensor,  a  programmed  reset  Instruction 
should  be  executed  which  clears  the  X  Register,  the  Y  Register,  and  the 
CSR.  It  is  accomplished  by  executing  a  data  transfer  Instruction  to  the 
CSR.  Once  executed,  repetition  of  this  Instruction  Is  not  necessary  In  the 
program  sequence. 

An  example  of  executing  a  programmed  reset  Is  as  follows: 

MOV  #1,  1764040;  Set  Bit  1  of  CSR. 


Selecting  the  Operating  Mode 

The  Touch  Sensor  has  two  operating  modes  that  can  be  selected 
under  program  control:  the  single  point  mode,  and  the  stream  mode.  If  the 
single  point  mode  Is  desired,  no  further  action  is  required  since  a  reset 
Instruction  Initiates  Che  Touch  Sensor  in  this  mode. 

If  the  scream  mode  Is  desired,  a  data  transfer  must  be  executed 
to  set  Bit  2  of  Che  CSR.  To  exit  the  stream  mode,  execute  either  the  RESET 
Instruction  which  clears  all  bits  In  the  CSR,  or  a  data  transfer  instruc¬ 
tion  which  resets  Bit  2  of  Che  CSR. 

The  following  are  examples  of  selecting  the  stream  mode  and 
selecting  the  single  point  mode: 

MOV  #2, @#164040;  Set  Bit  2  of  CSR  Selecting  Stream  Mode 

MOV  #0, @#164040;  Reset  Bit  2  of  CSR  Selecting  Single  Point 

Mode 


Sense  Data  Ready 

Before  transferring  the  data  in  the  X  and  Y  Registers,  the  CSR 
must  be  Interrogated  by  executing  a  data  transfer  Instruction  from  Che  CSR 
164040,  and  Interpreting  the  status  of  Che  Ready  Bit  7  of  the  CSR.  Bit  7 
being  set  Indicates  that  Che  X  and  Y  coordinate  data  Is  ready  to  be 
transferred  from  Che  Touch  Sensor. 


Select  X  and  Y  Registers 

After  determining  that  data  Is  ready  (see  Sense  Data  Ready),  the 
X  and  Y  Registers  may  now  be  selected.  The  X  and  Y  Registers  must  be 
accessed  by  two  data  transfer  instructions  executed  In  sequence.  This  Is 
required  to  reset  the  Touch  Sensor  for  continued  interaction.  The 
following  Is  an  example  of  accessing  the  X  and  Y  Registers: 

MOV  @#164042, RI;  Transfers  X  Data  to  R1 

MOV  @#164044, R2:  Transfers  Y  Data  to  R2 


This  sequence  of  Inscrucclon  places  Che  X  coordinate  in  R1  and 
Che  Y  coordinate  In  R2. 

Once  Che  X  and  Y  Register  contents  are  transferred  to  the 
computer,  the  Touch  Sensor  Is  ready  to  process  another  set  of  coordinate 
addresses . 


Interrupt  Request 

To  generate  Interrupts  with  the  Touch  Sensor,  Bit  6  of  the  CSR 
must  be  set  by  a  data  transfer  Inscrucclon.  The  following  Is  an  example  of 
setting  the  Interrupt  enable  bit: 

MOV  #100,@#1640A0;  Set  Bit  6  of  CSR 

Once  set,  any  finger  touch  Interaction  on  the  Touch  Panel 
generates  Interrupts  using  an  Interrupt  vector  of  170. 

The  interrupt  routine  should  then  service  the  X  and  Y  register 
with  two  consecutive  MOV  instructions.  Completion  of  the  second  MOV 
Instruction  resets  the  Touch  Sensor  for  continued  touch  Interaction. 


APPENDIX  A 


UNIBUS  ADDRESSES  AND  STATUS  REGISTER  BIT  ASSIGNMENTS 


Device  Register  Address 

CSR  764040 
X  Reg  764042 
Y  Reg  764044 


Int.  Vector  Priority 

Select  from  available 
floating  vectors. 


COMMAND  STATUS  REGISTER  BIT  ASSIGNMENTS: 

BIT  #  07  06  05  04  03  02  01  00 

XX  1 

X  1 

1  X 

XX  1 


Function 

Reset 

Int .  Enable 
Ready 
Stream 


» 
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TOUCH  SENSOR  INTERFACE  SOFTWARE 


USER'S  GUIDE 


INTRODUCTION 

The  Touch  Sensor  Interface  Software  provides  easy  access  to  the  Bio¬ 
graphies  Model  E-27AO  Transparent  Touch  Sensor  from  FORTRAN  programs.  The 
touch  sensor  hardware  Is  Interfaced  to  the  PDP-11/34  minicomputer  via  an 
Interface  controller  which  was  developed  by  the  U.S.  Army  Human  Engineering 
Laboratory  (USAHEL). 

The  Touch  Sensor  Interface  Software  consists  of  one  relocatable  ob¬ 
ject  module,  TSINT.OBJ,  which  contains  two  FORTRAN-cal lable  subroutines. 
This  document  describes  those  subroutines  and  the  procedures  necessary  to 
Incorporate  them  into  a  FORTRAN  task. 


REQUIREMENTS  AND  RESTRICTIONS 

The  Touch  Sensor  Interface  Software  uses  the  Connect  to  Interrupt 
Vector  (CINT$)  directive  to  gain  access  to  the  touch  sensor  hardware.  Some 
of  the  code  within  the  Interface  module  executes  as  if  it  were  part  of  the 
RSX-llM  executive.  This  leads  to  the  following  requirements  and 
restrictions . 

For  any  task  which  uses  Che  Touch  Sensor  Interface  Software: 

a.  The  task  must  be  built  as  a  privleged  task  (/PR:0  switch  re¬ 
quired  in  TKB  command).  This  implies  chat  the  task  must  be 
installed  if  It  is  to  be  run  from  a  nonpriviledged  terminal. 

b.  The  task  must  be  rebuilt  after  each  system,  using  the  new 
executive  symbol  table  file  (RSXllM.STB) .  Failure  to  do  so 
will  cause  the  system  to  crash  when  the  task  tries  to  access 
the  touch  sensor. 

c.  The  task  will  automatically  become  checkpointable  after  a 
call  to  the  Couch  sensor  Interface,  regardless  of  its  state 
prior  to  the  call.  The  task  will  be  noncheckpolntable  while 
executing  within  the  touch  sensor  interface. 

d.  Local  event  flags  23  and  24  are  used  by  the  touch  sensor  in¬ 
terface  routines  and  may  not  be  used  elsewhere  in  the  pro¬ 

gram. 

e.  Code  must  be  executed  at  the  priority  level  of  the  task  for 

each  touch  point  read  In  stream  mode.  Therefore,  the  pri¬ 

ority  of  the  task  must  be  sufficiently  high  to  guarantee  that 
the  maximum  delay  in  execution  of  the  task  is  less  than  33 
milliseconds  to  avoid  missing  data  points. 
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INTERFACt;  DESCRIPTION 


The  touch  sensor  has  two  modes  of  operation  termed  single-point  mode 
and  stream  mode.  Single-point  mode  Is  used  to  read  the  coordinates  of  a 
single  touchpolnt.  Stream  mode  Is  used  to  read  the  coordinates  of  a  series 
of  points  as  would  be  generated  by  an  operator  wiping  a  pointer  across  the 
screen.  No  data  is  generated  in  either  of  these  modes  until  the  screen  is 
touched.  In  stream  mode,  the  touch  coordinates  are  read  at  the  60  hertz 
rate  as  long  as  the  screen  Is  being  touched.  Both  input  modes  are 
supported  by  subroutine  TSREAD. 

Subroutine  TSNOW  jjermlts  program-controlled  polling  of  the  touch  sen¬ 
sor  Interface  to  determine  If  It  has  l>een  touched  and  to  obtain  the 
cooordlnates  of  the  last  touchpolnt. 

All  touchpolnt  coordinates  are  returned  as  a  pair  of  16-bit  integers, 
each  with  a  range  of  0  to  1023.  The  first  Integer  of  the  pair  contains  the 
X  coordinate  (horizontal)  and  the  second  contains  the  y  coordinate  (verti¬ 
cal).  The  lower,  left-hand  corner  of  the  screen  Is  the  origin  and  has  x 
and  y  coordinate  values  of  zero. 


Subroutine  TSREAD 

TSREAD  is  called  to  read  the  coordinates  of  the  next  point  touched,  or 
of  a  series  of  points.  TSREAD  allows  other  tasks  to  execute  while  it  is 
waiting  for  input  from  the  touch  sensor. 


Calling  Sequence 

CALL  TSREAD  (IBUF,IPTS,ITIMO,ISTAT) 

IBUF  An  array  which  will  receive  the  x  and  y  coordinate  data:  Two 
words  in  IBUF  are  used  for  each  point  read.  The  x  coordinate 
value  is  stored  in  the  first  word  and  the  y  coordinate  data 
is  stored  in  the  second  word  of  each  pair. 

IPTS  Number  of  points  to  be  read;  Note  that  the  size  of  IBUF  must 
be  at  least  twice  the  value  specified  for  IPTS. 

ITIMO  Timeout  value,  in  seconds:  Maximum  time  for  the  entire  oper¬ 
ation  to  complete.  If  ITIMO  is  set  to  zero,  the  operation 
will  not  be  timed. 

ISTAT  Completion  Status:  A  positive  value  indicates  successful 
completion  and  provides  the  number  of  points  actually  read. 
If  a  stream  mode  read  operation  times  out  before  IPTS  points 
are  read,  ISTAT  will  be  positive  and  less  than  IPTS.  A  nega¬ 
tive  value  indicates  an  error  and  provides  the  system  error 
code  from  the  Directive  Status  Word  ($D5W). 
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Usage 


TSREAD  enables  the  touch  sensor  for  operation  in  the  single-point  or 
stream  mode,  as  appropriate.  Operation  In  the  single-point  mode  (IPTS=1) 
Is  straightforward.  Operation  in  stream  mode,  however,  requires  additional 
consideration. 

A  timeout  value  should  always  be  specified  when  IPTS  is  greater  than 
one.  If  no  timeout  is  specified,  TSREAD  will  not  return  until  the  number 
of  points  requested  has  been  read.  The  selection  of  a  timeout  interval  is 
application  dependent.  However,  if  too  long  of  a  timeout  interval  is  used, 
there  may  be  a  significant  delay  from  the  time  that  the  operator  breaks 
contact  with  the  screen  until  the  program  responds.  If  the  timeout  inter¬ 
val  is  too  short,  the  operator  may  not  have  time  to  respond.  One  possible 
approach  is  to  read  the  first  of  a  series  of  points  using  single  point  mode 
with  no  timeout,  and  the  rest  of  the  points  using  a  series  of  stream  mode 
reads  with  relatively  short  timeouts. 


Subroutine  TSNOW 

TSNOW  returns  the  current  contents  of  the  touch  sensor's  x  and  y 
coordinate  registers  if  the  data  in  those  registers  has  not  already  been 
read.  TSNOW  does  not  wait  for  the  screen  to  be  touched  before  It  reads  the 
touch  sensor  coordinates. 


Call  Sequence 

CALL  TSNOW  (IBUF,ISTAT) 

IBUF  A  two-word  array  which  will  receive  the  current  contents  of 
the  X  and  y  coordinate  registers.  The  x  coordinate  value  is 
stored  in  IBUF(l)  and  the  y  coordinate  value  is  stored  in 
IBUF(2). 

ISTAT  Completion  Status: 

1  =  Operation  completed  successfully. 

0  No  current  data  in  the  x/y  registers. 

A  negative  value  indicates  an  error  and  provides  the  system 
error  code  from  the  Directive  Status  Word  ($D5W). 
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TASKBUILDING 


The  following  must  be  considered  when  tasKbullding  a  task  which  uses 
the  Touch  Sensor  Interface  Software: 

1.  The  task  must  be  made  prlvlledged  by  including  a  /PR:0  switch 
on  the  task  file  specification. 

2.  The  touch  sensor  Interface  module,  TSINT.OBJ,  must  be  Included. 

3.  The  current  executive  symbol  table  file,  LB;  1,54  RSXllM.STB 
must  be  Included. 

The  touch  sensor  Interface  module  may  be  Included  in  the  System 
Library,  in  which  case  no  special  action  Is  required  to  have  It  Included 
automatically  in  the  task. 

A  sample  taskbullder  command  line  to  build  a  task  consisting  of  one 
FORTRAN  module  follows; 

TKB  TSTSK/PR:0=TSTSK,LB:  1,54  RSXllM.STB 

This  example  assumes  that  TSINT.OBJ  has  been  included  in  the  System 
Library. 
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